Skip to content

Add remote tasks lesson and resist-the-manual-refactor section#5

Merged
niallkeys merged 3 commits into
mainfrom
add-remote-tasks-and-resist-manual-refactor
Feb 16, 2026
Merged

Add remote tasks lesson and resist-the-manual-refactor section#5
niallkeys merged 3 commits into
mainfrom
add-remote-tasks-and-resist-manual-refactor

Conversation

@niallkeys
Copy link
Copy Markdown
Contributor

Summary

  • New Lesson 14: Remote Tasks — covers delegating work to Claude.ai cloud sessions via /task, comparison with headless mode, and the end-of-day workflow pattern (fire off a task before logging off, review results in the morning)
  • New section in Lesson 3: "Resist the manual refactor" — teaches users to tell Claude to update CLAUDE.md when it makes a mistake, rather than manually fixing the code. A manual fix solves it once; a CLAUDE.md update solves it forever
  • All subsequent lessons renumbered (14→15 through 21→22) with updated references across welcome page, skills, validators, and CLAUDE.md

Test plan

  • Run through /progress and verify all 23 lessons (0–22) display correctly with correct titles
  • Navigate with /next from lesson 13 → 14 → 15 and confirm correct lesson content loads
  • Run /qa and verify it starts at lesson 18
  • Check validators for lessons 15, 18–21 fire on the correct exercises
  • Verify lesson 3 renders the new "Resist the manual refactor" section after "The golden rule"

🤖 Generated with Claude Code

Two additions to the tutorial:

1. New Lesson 14 (Remote Tasks) — covers delegating work to Claude.ai
   cloud sessions via /task, when to use remote vs headless mode, and
   the end-of-day workflow pattern.

2. "Resist the manual refactor" section in Lesson 3 — teaches the habit
   of telling Claude to update CLAUDE.md when it makes a mistake, rather
   than manually fixing the code. Captures rules permanently instead of
   correcting in chat.

All subsequent lessons renumbered (14→15 through 21→22) with updated
references in welcome page, skills, validators, and CLAUDE.md.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings February 16, 2026 23:31
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This pull request adds a new lesson on remote tasks and a new section about resisting manual refactors, with subsequent lessons renumbered accordingly. The PR adds lesson 14 "Remote Tasks" which teaches users how to delegate work to Claude.ai cloud sessions, adds a "Resist the manual refactor" section to lesson 3 that encourages users to update CLAUDE.md instead of manually fixing code, and renumbers all subsequent lessons (14→15 through 21→22) with corresponding updates to validators, skills, and documentation.

Changes:

  • New lesson 14 introduces remote tasks via the /task command, explaining the difference from headless mode and the end-of-day workflow pattern
  • New section in lesson 3 teaches the practice of updating CLAUDE.md when Claude makes mistakes, emphasizing persistent solutions over one-time manual fixes
  • All lessons from former 14 onwards renumbered by one (14→15, 15→16, 16→17, 17→18, 18→19, 19→20, 20→21, 21→22)

Reviewed changes

Copilot reviewed 22 out of 22 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
tutorial/lessons/14-remote-tasks.md New lesson teaching remote task delegation via /task command
tutorial/lessons/03-context-and-claude-md.md Added "Resist the manual refactor" section promoting CLAUDE.md updates over manual fixes
tutorial/lessons/15-cli-tools-and-mcp.md Renumbered from lesson 14 to 15
tutorial/lessons/16-working-with-images.md Renumbered from lesson 15 to 16
tutorial/lessons/17-graduation.md Renumbered from lesson 16 to 17, updated reference to lesson 15
tutorial/lessons/18-test-planning.md Renumbered from lesson 17 to 18
tutorial/lessons/19-test-case-design.md Renumbered from lesson 18 to 19
tutorial/lessons/20-automated-test-generation.md Renumbered from lesson 19 to 20
tutorial/lessons/21-e2e-testing-playwright.md Renumbered from lesson 20 to 21
tutorial/lessons/22-qa-track-graduation.md Renumbered from lesson 21 to 22
tutorial/lessons/00-welcome.md Updated lesson list to include lesson 14 and renumbered subsequent lessons
tutorial/validators/validate-15.sh Updated from lesson 14 to lesson 15 throughout
tutorial/validators/validate-17.sh Deleted (content moved to validate-18.sh)
tutorial/validators/validate-18.sh Updated from lesson 17 content to lesson 18
tutorial/validators/validate-19.sh Updated from lesson 18 content to lesson 19
tutorial/validators/validate-20.sh Updated from lesson 19 content to lesson 20
tutorial/validators/validate-21.sh New validator for lesson 21 (formerly lesson 20)
CLAUDE.md Updated QA track range from 17-21 to 18-22, core track from 0-16 to 0-17
.claude/skills/next/SKILL.md Updated core track cap from 16 to 17, QA track cap from 21 to 22
.claude/skills/skip/SKILL.md Updated core track cap from 16 to 17, QA track cap from 21 to 22
.claude/skills/progress/SKILL.md Updated progress display to show lesson 14 and renumbered subsequent lessons, updated totals
.claude/skills/qa/SKILL.md Updated QA track start from lesson 17 to 18

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread tutorial/lessons/14-remote-tasks.md Outdated
Resolve conflicts in validate-15.sh (take main's api-response.json
logic, update lesson numbers to 15) and 17-graduation.md (take main's
GitHub MCP challenge, update lesson reference to 15).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
niallkeys pushed a commit that referenced this pull request Feb 16, 2026
- Replace sqlite3 exercise with curl in Lesson 14 (curl ships on both platforms)
- Rewrite validate-14.sh to check api-response.json using Node.js instead of sqlite3
- Add Windows key bindings (Win+Shift+S, Ctrl+Click) to Lesson 15
- Fix Unix-centric language in Lesson 13 ("Unix tools" → "command-line tools")
- Update graduation bonus challenge #5 to reference curl/GitHub MCP instead of sqlite3
- Update README with cross-platform install instructions and Git Bash prerequisite

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@niallkeys niallkeys merged commit 77889d5 into main Feb 16, 2026
@niallkeys niallkeys deleted the add-remote-tasks-and-resist-manual-refactor branch February 16, 2026 23:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants